home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / misc / vndnfo12.zip / VENDEDIT.DOC < prev    next >
Text File  |  1995-03-12  |  76KB  |  2,125 lines
  1.  
  2.     
  3.  
  4.  
  5.  
  6.  
  7.                  +-----------------------------------------+
  8.                  |                                         |
  9.                  |                                         |
  10.                  |               User's Guide              |
  11.                  |                                         |
  12.                  |           VendEdit(TM) Editor           |
  13.                  |    for creating VENDINFO(TM) records    |
  14.                  |             Version 1.21-044            |
  15.                  |                                         |
  16.                  |                                         |
  17.                  |         Last updated: March 1995        |
  18.                  |                                         |
  19.                  |                                         |
  20.                  | Copyright 1993-95 Rams' Island Software |
  21.                  |           All rights reserved           |
  22.                  |                                         |
  23.                  +-----------------------------------------+
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.    Rams' Island Software
  45.    7644 E. Lakecliff Way                   _______
  46.    Parker, CO 80134-5904 (USA)        ____|__     |                (R)
  47.                                    --|       |    |-------------------
  48.    Voice:    (303) 841-2848          |   ____|__  |  Association of
  49.    BBS/FAX:  (303) 841-6269          |  |       |_|  Shareware
  50.    CompuServe: 76244,324             |__|   o   |    Professionals
  51.                                    -----|   |   |---------------------
  52.    FidoNet:  1:104/333                  |___|___|    MEMBER
  53.    RIME:     1235
  54.    Internet: 76244.324@compuserve.com
  55.  
  56.  
  57.                                                                            
  58.  
  59.  
  60.  
  61.  
  62.    VendEdit User's Guide                                           VendEdit
  63.  
  64.  
  65.                               +-----------------+
  66.                               | Acknowledgments |
  67.                               +-----------------+
  68.  
  69.    Many people have helped to mold the VENDINFO vision, and to provide
  70.    support and encouragement throughout its development process. Thanks are
  71.    given to all those who have reviewed the Concept Paper or the VENDINFO
  72.    standard, or who have otherwise made suggestions regarding the project.
  73.  
  74.    The author is especially grateful to Fred Hill and Richard Holler, for
  75.    long-term support and help with VENDINFO.
  76.  
  77.    While many have reviewed parts of the VENDINFO documentation, special
  78.    thanks go to Jim Green, for helping us avoid a wrong direction; to Bob
  79.    Ostrander for a simple but particularly powerful idea; and to Daan van
  80.    Rooijen, for really studying the standard and providing many, many
  81.    useful suggestions.
  82.  
  83.    Many people have also helped in beta testing the VENDINFO tools, and
  84.    we're grateful to them all. Special thanks are given to Steve Estvanik,
  85.    Jerry Stern, and Rosemary West, for really giving things a workout, and
  86.    tirelessly reporting the results.
  87.  
  88.    The VENDINFO team is grateful to the following shareware trade associa-
  89.    tions for their endorsements of VENDINFO:
  90.  
  91.       Association of Shareware Professionals (ASP)
  92.       Association of Shareware Authors and Distributors (ASAD)
  93.       Shareware Trade Association and Resources (STAR)
  94.       Educational Software Copperative (ESC)
  95.  
  96.    Finally, we particularly appreciate the 30-or-so software development
  97.    teams (mostly BBS-related) whose early commitment to support the
  98.    VENDINFO standard in their software products has helped provide momentum
  99.    and visibility to this effort.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.    VENDINFO, VendEdit, VendPrcs, VendView, and VendLib are trademarks of
  112.    Rams' Island Software.
  113.  
  114.  
  115.  
  116.    VendEdit Editor v1.21              -ii-                         Mar 1995
  117.  
  118.  
  119.  
  120.  
  121.    VendEdit User's Guide                                  Table of Contents
  122.  
  123.  
  124.                              +-------------------+
  125.                              | Table of Contents |
  126.                              +-------------------+
  127.  
  128.  
  129.     The VENDINFO System ................................................  1
  130.        Components of the System ........................................  1
  131.        Structure of a VENDINFO File ....................................  2
  132.        A Little Background .............................................  3
  133.        Industry Support and Endorsements ...............................  4
  134.        Other VENDINFO Documents and Packages ...........................  5
  135.  
  136.     Installation .......................................................  7
  137.        Quick Start .....................................................  7
  138.        Detailed Contents of the VendEdit Package .......................  8
  139.        VendView: Free VENDINFO.DIZ Viewer for End Users ................ 10
  140.        Special Tips for the Inexperienced Shareware Author ............. 10
  141.        Warranty and License ............................................ 10
  142.        Technical Support for VendEdit .................................. 11
  143.  
  144.     Overview of the VendEdit Process ................................... 13
  145.  
  146.     Making a VENDINFO Intermediate File ................................ 15
  147.        Prepare Text Materials .......................................... 15
  148.        Packaging Directory(s) .......................................... 16
  149.        Invoke VendEdit ................................................. 17
  150.        Edit Author/Publisher Information ............................... 17
  151.        Edit Product Information ........................................ 18
  152.        Edit Order Information .......................................... 18
  153.        Edit Distributor Information .................................... 18
  154.        Edit Support Information ........................................ 19
  155.        Edit Price/Benefit Information .................................. 19
  156.        Edit General (Channel-Independent) Distribution Policy .......... 19
  157.        Edit Channel-Specific Distribution Policy ....................... 20
  158.        Edit Front Text ................................................. 20
  159.  
  160.     Verifying the Intermediate File .................................... 22
  161.  
  162.     Exporting VENDINFO.DIZ and Other Files ............................. 23
  163.  
  164.     Checking the Results ............................................... 24
  165.  
  166.     The VENDINFO Product Registry ...................................... 25
  167.  
  168.     A Bit of Philosophy ................................................ 27
  169.        Philosophy Regarding Distribution Restrictions .................. 27
  170.        Algorithm Used for Distribution Permission Tests ................ 28
  171.        Legal Matters ................................................... 29
  172.  
  173.  
  174.  
  175.    VendEdit Editor v1.21             -iii-                         Mar 1995
  176.  
  177.  
  178.  
  179.  
  180.    VendEdit User's Guide                                  Table of Contents
  181.  
  182.  
  183.     Security ........................................................... 31
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.    VendEdit Editor v1.21             -iv-                         Mar 1995
  235.  
  236.  
  237.  
  238.  
  239.  
  240.    VendEdit User's Guide                           Introduction to VENDINFO
  241.  
  242.  
  243.     
  244.                             +---------------------+
  245.                             | The VENDINFO System |
  246.                             +---------------------+
  247.  
  248.       VENDINFO is a system for conveying software product information and
  249.       distribution permissions from the author to distributors and users. A
  250.       standard (public) file format allows a VENDINFO.DIZ file to carry
  251.       extensive information in a compressed, efficient form. The associated
  252.       toolset:
  253.  
  254.            o  aids the author in constructing the record
  255.  
  256.            o  allows the distributor to extract portions of the record, or
  257.               to make distribution decisions based on its content, in a
  258.               highly automated way
  259.  
  260.            o  allows the user to view user-relevant product information
  261.               quite easily.
  262.  
  263.  
  264.       VENDINFO provides unprecedented capabilities for
  265.  
  266.            o  Communication of product information and distribution
  267.               policies from authors to users and distributors.
  268.  
  269.            o  Automation of many aspects of package handling by shareware
  270.               distributors of all types.
  271.  
  272.  
  273.  
  274.    Components of the System
  275.    ------------------------
  276.  
  277.       The VENDINFO "record" is the key. This is an efficiently compressed
  278.       file (VENDINFO.DIZ) containing a great deal of information about the
  279.       product, the author, and the product's distribution policies.
  280.  
  281.       The VendEdit editor allows the author to construct a complete
  282.       VENDINFO record in just a few minutes, assuming that the necessary
  283.       descriptive texts have already been prepared.
  284.  
  285.       The VendPrcs (pronounced "vend process") processor is a batch program
  286.       allowing automated decisions based on VENDINFO content, and automated
  287.       extraction of VENDINFO information.
  288.  
  289.       VendView is a simple menu-driven viewer that allows the end-user to
  290.       se relevant portions of the VENDINFO data. Even without VendView, an
  291.       ordinary text viewer will display a good deal of useful information.
  292.  
  293.  
  294.    VendEdit Editor v1.21              -1-                          Mar 1995
  295.  
  296.  
  297.  
  298.  
  299.    VendEdit User's Guide                           Introduction to VENDINFO
  300.  
  301.  
  302.       The Product Registry is a collection of VENDINFO records available
  303.       for searches and queries by subscription, BBS login, or mail-order
  304.       query.
  305.  
  306.       The VendLib Library allows software developers to build VENDINFO
  307.       access directly into such products as BBS programs and upload proces-
  308.       sors. This library is already in the hands of some 30 vendors of
  309.       BBSes, BBS utility software, and other relevant software.
  310.  
  311.       The file-format standard describing the VENDINFO file is public, and
  312.       draft versions have been published since July 1993. The final version
  313.       1.00 has been released, and is the basis for the current toolset.
  314.  
  315.       VendPrcs Plus, a non-shareware version of VendPrcs, is in the plan-
  316.       ning stages. It will have a full-screen interface, using scripts for
  317.       easier, more efficient information extraction, and templates for
  318.       easier description of decision situations. It will also allow manage-
  319.       ment of a library of VENDINFO files, and will provide automated
  320.       access to the Product Registry BBS.
  321.  
  322.       Additional services for authors, users, and distributors are under
  323.       consideration.
  324.  
  325.  
  326.    Structure of a VENDINFO File
  327.    ----------------------------
  328.  
  329.       The VENDINFO.DIZ file contains two sections. A human-readable front
  330.       section contains information about how to use the VENDINFO file, and
  331.       presents most of the basic information about the product in readable
  332.       form. Optionally, it also includes "read-me" text, installation
  333.       instructions, and the product's warranty and trial-use license.
  334.  
  335.       The second section is a binary data record, compressed with a PKZIP
  336.       1.10 algorithm, and appended to the file after the first section.
  337.       This record has some 750 fields of information about such things as
  338.  
  339.            o  Product name, date, and version
  340.  
  341.            o  Preferred package filename, other parts of product, replaced
  342.               versions
  343.  
  344.            o  Product descriptions of varying length, categories, keywords
  345.  
  346.            o  Required platform (CPU, operating system, memory, disk,
  347.               features)
  348.  
  349.            o  Contact information for author, for registering, for tech
  350.               support
  351.  
  352.  
  353.    VendEdit Editor v1.21              -2-                          Mar 1995
  354.  
  355.  
  356.  
  357.  
  358.    VendEdit User's Guide                           Introduction to VENDINFO
  359.  
  360.  
  361.            o  Registration prices and benefits, acceptable forms of payment
  362.  
  363.            o  Detailed distribution policy, in general and by distribution
  364.               channel
  365.  
  366.            o  Information about regional distributors and registration
  367.               services.
  368.  
  369.       There is also a specialized version of the VENDINFO file, called
  370.       VENDINFO.DOZ (for Description Out of Zip), which can contain addi-
  371.       tional information for use by CD-ROM front ends, as an electronic
  372.       media kit, and for other uses. This file can even contain screen-
  373.       shots, icons, sound samples, a logo, advertising screen, press
  374.       release, reviewer guidelines, company background, author biography,
  375.       product features sheet, question-and-answer sheet, and other em-
  376.       bedded, compressed files. CD-ROM front ends will soon be using this
  377.       information, as will the free VendView viewer.
  378.  
  379.  
  380.    A Little Background
  381.    -------------------
  382.  
  383.       The author of the VENDINFO standard and tools, Rudy Ramsey, has been
  384.       agitating since early 1992 for the development of an improved
  385.       mechanism for conveying product information and permissions from
  386.       authors to distributors. Initially, the intent was to make this a
  387.       purely volunteer-based effort, probably conducted within the auspices
  388.       of the Association of Shareware Professionals. However, others were
  389.       slow to respond to the idea (with the exception of Richard Holler and
  390.       Fred Hill), and it gradually became clear that it would have to be
  391.       done as an "extracurricular" effort, if at all.
  392.  
  393.       In the Spring of 1993, Rudy began the VENDINFO effort in earnest, by
  394.       preparing the CONCEPT.DOC concept paper and distributing it to a few
  395.       key shareware industry figures for comment. (At this time, he still
  396.       imagined VENDINFO as an all-volunteer effort.) The reviewers were
  397.       uniformly excited about the idea, and greatly encouraging. Most felt
  398.       that it was an idea whose time had come, and that the technical
  399.       approach described in the concept paper was very appropriate.
  400.  
  401.       Their second response, however, was that the effort contained the
  402.       seeds of its own failure. It might provide all the necessary incen-
  403.       tives for participation by authors, distributors, and users. But if
  404.       it didn't also provide an incentive for continued development and
  405.       support by its own development team, it would fail. It was simply too
  406.       big an activity for successful execution by volunteers.
  407.  
  408.       As a result of that input, a decision was made to regard VENDINFO as
  409.       partly a business opportunity. Although this makes a few people
  410.  
  411.  
  412.    VendEdit Editor v1.21              -3-                          Mar 1995
  413.  
  414.  
  415.  
  416.  
  417.    VendEdit User's Guide                           Introduction to VENDINFO
  418.  
  419.  
  420.       suspicious, most agree it's in the best interest of the VENDINFO
  421.       effort itself, and of the industry. In fact, VENDINFO has developed
  422.       rapidly, partly because it has been a full-time focus of its author
  423.       for many months. That wouldn't have been possible in an all-volunteer
  424.       effort.
  425.  
  426.       The VENDINFO file-format standard is public. A substantial period was
  427.       provided for public comment on the concept paper, and then on the
  428.       standard, and public input is always welcome. Some of the tools that
  429.       make use of the standard are free (a viewer for end users, and the
  430.       processor when used by single-line, noncommercial BBSes). Most are
  431.       low-cost shareware. There will also be much-enhanced, non-shareware
  432.       programs later, for special purposes, but none of them are necessary
  433.       to achieve the benefits of the VENDINFO system.
  434.  
  435.  
  436.    Industry Support and Endorsements
  437.    ---------------------------------
  438.  
  439.       Support for the VENDINFO concept has been extraordinarily high
  440.       throughout the industry. Authors, disk vendors, CD-ROM publishers,
  441.       Sysops, and BBS software manufacturers have all expressed their
  442.       support, and many have pledged to build VENDINFO capability into
  443.       their own software products.
  444.  
  445.       The following shareware trade groups have formally endorsed the
  446.       VENDINFO file-format standard as a means of conveying product and
  447.       product-distribution information from authors to users and dis-
  448.       tributors.
  449.  
  450.          Association of Shareware Professionals (ASP)
  451.          Shareware Trade Association and Resources (STAR)
  452.          Association of Shareware Authors and Developers (ASAD)
  453.          Educational Software CoOperative (ESC)
  454.  
  455.       The ASP has licensed the VENDINFO toolset for use by all 1700 of its
  456.       members. This will greatly accelerate the use -- and the usefulness
  457.       -- of VENDINFO.
  458.  
  459.       The following software manufacturers have "committed in principle" to
  460.       support VENDINFO in their own software offerings by mid-1994. In the
  461.       context of these products, "support" for VENDINFO means extracting
  462.       relevant descriptive information automatically from VENDINFO files.
  463.       It does not necessarily mean making decisions based on the product's
  464.       distribution policy. VendPrcs will provide that capability.
  465.  
  466.          BBSes
  467.  
  468.             PCBoard, Clark Development Co.
  469.  
  470.  
  471.    VendEdit Editor v1.21              -4-                          Mar 1995
  472.  
  473.  
  474.  
  475.  
  476.    VendEdit User's Guide                           Introduction to VENDINFO
  477.  
  478.  
  479.             Wildcat!, Mustang Software, Inc.
  480.             Major BBS, Galacticomm
  481.             RBBS, RBBS Development Team
  482.             Searchlight BBS, Searchlight Software
  483.             TBBS, eSoft
  484.             Auntie BBS, Wes Meier
  485.             Executive Host BBS, Steve Wood
  486.             MainLine BBS, Scott Green, City Limits Software
  487.             OmegaComm BBS, Larry Loiselle
  488.             PowerBBS for Windows, Russell Frey
  489.             ProBoard BBS, Philippe Leybaert
  490.             Sapphire BBS, Pinnacle Software
  491.             Tinyhost, Bruce Krobusek
  492.             UltraBBS, UltraBBS Software
  493.             Windowed Modem Environment, Jason Fesler
  494.  
  495.          File Upload Processors
  496.  
  497.             CatScan, Mike Ortiz
  498.             CheckZip, Bill Hull
  499.             DIZIT, Robert Neal/CorpSoft
  500.             HoboScan, Floyd Hobson
  501.           **THD Proscan, David Muir
  502.           **TransScan, Craig Dunstan
  503.  
  504.          File Distribution Processors
  505.  
  506.             WCFF, Online Computer Resources
  507.  
  508.          Other Products
  509.  
  510.           **BBSee Disk Cataloger, Martin Vallevand
  511.           **Catalog-on-a-Disk, EmmaSoft Software Company, Inc.
  512.             Colorado Utilities Disk Manager, Micro Systems Solutions
  513.           **SmartCat Disk Cataloger, Oakley Data Services
  514.  
  515.        * Test versions are known to exist which support VENDINFO
  516.       ** Released products support VENDINFO
  517.  
  518.  
  519.    Other VENDINFO Documents and Packages
  520.    -------------------------------------
  521.  
  522.       The VENDINFO idea is documented in detail in a concept paper and in
  523.       the VENDINFO file-format standard. These two documents are available
  524.       in the VENDINFO information package, usually named VNDINFxx.ZIP
  525.       (where xx represents the version number).
  526.  
  527.       The basic VENDINFO Toolkit (for authors and distributors) is avail-
  528.  
  529.  
  530.    VendEdit Editor v1.21              -5-                          Mar 1995
  531.  
  532.  
  533.  
  534.  
  535.    VendEdit User's Guide                           Introduction to VENDINFO
  536.  
  537.  
  538.       able in the VendTools package, usually named VNDNFOxx.ZIP. The
  539.       VendView viewer package, for end-users, is usually named
  540.       VNDVUExx.ZIP. The VendUtil package contains a collection of utilities
  541.       and other useful information, and is usually named VNDUTLxx.ZIP.
  542.  
  543.       All of these can be obtained from the Rams' Island BBS on first login
  544.       or by FidoNet or RIME file request. (FidoNet magic names for current
  545.       versions consist of just the alphabetic portion of the package
  546.       prefix, as VNDINF, VNDNFO, VNDVUE, and VNDUTL.) They are also avail-
  547.       able in the CompuServe SHAREWARE and UKSHARE forums; the ASP Hub
  548.       Network BBSes; many local BBSes around the world, including those
  549.       associated with the Software Distribution Network; from some disk
  550.       vendors; and on the ASP, JSC, and PsL CD-ROMs.
  551.  
  552.       If necessary, the concept paper and evaluation versions of the basic
  553.       toolset can be obtained on diskette from Rams' Island Software for
  554.       US$ 6.00 in North America, $8.00 elsewhere. Payment is accepted by
  555.       Visa/MasterCard, check in U.S. dollars drawn on a U.S. bank, cash in
  556.       any hard currency (registered mail suggested), and various other
  557.       forms. cal BBSes around the world, including those associated with
  558.       the Software Distribution Network; from some
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.    VendEdit Editor v1.21              -6-                          Mar 1995
  590.  
  591.  
  592.  
  593.  
  594.    VendEdit User's Guide                                       Installation
  595.  
  596.  
  597.        
  598.                                +--------------+
  599.                                | Installation |
  600.                                +--------------+
  601.  
  602.       To install the VENDINFO Basic Toolset, simply unzip or copy all files
  603.       into a single directory, which will be devoted to VendEdit. If you
  604.       are an author, or you expect to create VENDINFO records for testing
  605.       purposes, you should plan to leave all these files in that directory.
  606.       If you are a distributor, and plan to use only VendPrcs, then it will
  607.       eventually be appropriate for you to place VENDPRCS.EXE on your path,
  608.       and many of these materials will not be needed after your
  609.       familiarization with the toolset is complete.
  610.  
  611.       Once you've installed this package:
  612.  
  613.          o  If you're an author, or wish to try out VendEdit, simply
  614.             execute the command "VENDEDIT" WHILE IN THE VendEdit DIRECTORY.
  615.             Select "Help", and read through the first few items in the
  616.             help index.  You should find all the information you need.
  617.  
  618.          o  If you're a distributor, or wish to try out VendPrcs, you
  619.             should begin by reading VENDPRCS.DOC.  For authors, the
  620.             basic VendPrcs functions are executed automatically from
  621.             VendEdit.
  622.  
  623.  
  624.    Quick Start
  625.    -----------
  626.  
  627.       If you want to try using VendEdit with the absolute minimum of in-
  628.       struction it is suggested that you read the following chapters of
  629.       this User Guide
  630.  
  631.          Introduction to VENDINFO (earlier in this user guide)
  632.  
  633.          Overall Process of Using VendEdit (later in this user guide)
  634.  
  635.       Alternatively, you can read the corresponding sections of the
  636.       VendEdit help text. Just go to the VendEdit directory, invoke
  637.       VENDEDIT.EXE, and press Alt-H for the help system index. You can then
  638.       place the cursor on the section you want to read, and press ENTER.
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.    VendEdit Editor v1.21              -7-                          Mar 1995
  649.  
  650.  
  651.  
  652.  
  653.    VendEdit User's Guide                                       Installation
  654.  
  655.  
  656.       Once you've read this introductory material, simply invoke VENDEDIT
  657.       and follow this simple instruction:
  658.  
  659.            ───────────────────────────────────────────────────┐
  660.           │  Work your way left-to-right, and top-to-bottom,  │
  661.           │       through the VendEdit menu structure.        │
  662.           └───────────────────────────────────────────────────┘
  663.  
  664.       You should be prepared to make extensive use of the context-sensitive
  665.       help that's available throughout VendEdit. Even the menu items that
  666.       only lead to other menu items have useful help text. Just press F1.
  667.  
  668.  
  669.    Detailed Contents of the VendEdit Package
  670.    -----------------------------------------
  671.  
  672.       The VENDINFO toolset package includes the following files that are
  673.       specifically relevant to the VendEdit editor:
  674.  
  675.          VENDEDIT.DOC   This document.
  676.  
  677.          REGISTER.FRM   Registration form for VendEdit, and several other
  678.                         products and services associated with the VENDINFO
  679.                         system.
  680.  
  681.          VENDEDIT.EXE   The executable program for VendEdit.
  682.  
  683.          VENDEDIT.HLP   Help file used by VendEdit.
  684.  
  685.          VENDEDIT.HST   A brief update history of VendEdit and related
  686.                         files.
  687.  
  688.          STATUS.DAT     A text file used by VendEdit for status messages.
  689.  
  690.          VERIFY.DAT     A text file used by VendEdit for testing the infor-
  691.                         mation you provide in your VENDINFO file.
  692.  
  693.          VENDPACK.EXE   A small compression program used by VendEdit.
  694.  
  695.          CATEGORY.INF   Product category data file used by VendEdit and
  696.                         VendPrcs.
  697.  
  698.          EXTRACT.BAT    A batch file used for extracting all fields from a
  699.                         VENDINFO.DIZ record. This batch file is invoked
  700.                         automatically by VendEdit's <T>est <C>ontents
  701.                         command, but may also be used separately.
  702.  
  703.          EXTRDIST.BAT   A batch file used for extracting distribution
  704.                         policy information for a single channel from a
  705.  
  706.  
  707.    VendEdit Editor v1.21              -8-                          Mar 1995
  708.  
  709.  
  710.  
  711.  
  712.    VendEdit User's Guide                                       Installation
  713.  
  714.  
  715.                         VENDINFO.DIZ file. This batch file is called from
  716.                         EXTRACT.BAT.
  717.  
  718.          EXTRREGL.BAT   A batch file used for extracting information about
  719.                         distributors of your registered version. This batch
  720.                         file is called from EXTRACT.BAT.
  721.  
  722.          TESTDIST.BAT   A batch file used to perform a variety of distribu-
  723.                         tion policy tests on a VENDINFO.DIZ file. This
  724.                         batch file is invoked automatically by VendEdit's
  725.                         <T>est <P>olicy command, but may also be used
  726.                         separately.
  727.  
  728.          TESTDOZ.BAT    A batch file used to test a VENDINFO.DOZ file. This
  729.                         batch file is invoked automatically by VendEdit's
  730.                         <T>est vendinfo.d<O>z command, but may also be used
  731.                         separately.
  732.  
  733.       It also includes these files, which are relevant to the VendPrcs
  734.       processor, which distributors will use to access information from
  735.       your VENDINFO.DIZ files:
  736.  
  737.          VENDPRCS.EXE   The VendPrcs program itself.
  738.  
  739.          VENDPRCS.DOC   The VendPrcs User Guide.
  740.  
  741.          VENDPRCS.HST   A brief update history of VendPrcs and related
  742.                         files.
  743.  
  744.          VPRESULT.CFG   A sample of the configuration file used to control
  745.                         part of the VendPrcs behavior.
  746.  
  747.          EXAMPLES.ZIP   A PKZIP-compressed file containing samples of other
  748.                         batch files that can be used with VendPrcs, sample
  749.                         VENDINFO.DIZ files, and the corresponding printouts
  750.                         of their content.
  751.  
  752.       Finally, the package contains these files, which describe the entire
  753.       VENDINFO toolset package:
  754.  
  755.          VENDINFO.DIZ   The VENDINFO.DIZ file that describes this whole
  756.                         VENDINFO toolset package. As a further introduc-
  757.                         tion, it's worth viewing with a text viewer.
  758.  
  759.          FILE_ID.DIZ    A small file containing a description of this
  760.                         package, currently used by many BBS and BBS-utility
  761.                         programs to automatically load such descriptions
  762.                         into their files databases. VENDINFO will even-
  763.                         tually render this convention obsolete, but
  764.  
  765.  
  766.    VendEdit Editor v1.21              -9-                          Mar 1995
  767.  
  768.  
  769.  
  770.  
  771.    VendEdit User's Guide                                       Installation
  772.  
  773.  
  774.                         FILE_ID.DIZ files should continue to be used, for
  775.                         now.
  776.  
  777.          VENDOR.DOC     A small "stub" pointing the distributor to
  778.                         VENDINFO.DIZ for information.
  779.  
  780.          READ_ME.1ST    A small "stub" pointing the user to VENDINFO.DIZ
  781.                         for information.
  782.  
  783.  
  784.    VendView: Free VENDINFO.DIZ Viewer for End Users
  785.    ------------------------------------------------
  786.  
  787.       You may also wish to obtain and install the VendView viewer. It is
  788.       available for use without charge, but is packaged separately from
  789.       VendEdit because it is also used by end users who have no need for
  790.       the VendEdit or VendPrcs programs. VendView is generally obtainable
  791.       as VNDVUExx.ZIP, where "xx" represents the version number.
  792.  
  793.       If VendView is installed, the user of VendEdit will be able to make
  794.       use of it in reviewing any VENDINFO.DIZ files that are created. It is
  795.       a significant convenience.
  796.  
  797.  
  798.    Special Tips for the Inexperienced Shareware Author
  799.    ---------------------------------------------------
  800.  
  801.       Aside from its ability to produce VENDINFO records, the VendEdit
  802.       editor can be a serious educational tool for the beginning shareware
  803.       author. Both the VENDINFO record and the VendEdit help text contain a
  804.       wealth of information about the description and distribution of
  805.       shareware. To take full advantage of this capability, it is suggested
  806.       that you read all the material in the help system, either by select-
  807.       ing Help and working your way through the index, or (perhaps better)
  808.       by working your way sequentially through the menu system, pressing F1
  809.       everywhere. Even the menu items, such as Edit and Verify, that only
  810.       lead to other menu items have useful help text associated with them.
  811.  
  812.  
  813.    Warranty and License
  814.    --------------------
  815.  
  816.       VendEdit and VendPrcs are shareware products, which you may fully
  817.       evaluate before deciding whether or not you wish to purchase them.
  818.       The Warranty and License governing your use of these products will be
  819.       found in the VENDINFO.DIZ file (read it or print it with the tools
  820.       you use for ordinary text files). Or, if you prefer, you'll find
  821.       these materials in the VendEdit help system.
  822.  
  823.  
  824.  
  825.    VendEdit Editor v1.21             -10-                          Mar 1995
  826.  
  827.  
  828.  
  829.  
  830.    VendEdit User's Guide                                       Installation
  831.  
  832.  
  833.    Technical Support for VendEdit
  834.    ------------------------------
  835.  
  836.       If you have a problem with installation or use of this product, and
  837.       the documentation doesn't provide the help you need, you are welcome
  838.       to contact us. You can do this in any of several ways.
  839.  
  840.       RAMS' ISLAND BBS
  841.  
  842.       The Rams' Island BBS is a bulletin board system, accessible to you if
  843.       if you have a modem and communication software. On our BBS, you will
  844.       always find the latest version of the program, and you will be able
  845.       to ask technical questions of us and of our other users. We also
  846.       offer additional utilities, class definitions, application notes, and
  847.       other assistance to registered users via the BBS. The BBS phone
  848.       number is 303-841-6269.
  849.  
  850.       COMPUSERVE INFORMATION SYSTEM
  851.  
  852.       We also support this product on the CompuServe information system.
  853.       The latest version of the program is always available there in the
  854.       SHAREWARE and UKSHARE forums, and technical questions and support
  855.       requests may be sent to us via electronic mail there or on the
  856.       CompuServe SHAREWARE and UKSHARE forums. Our CompuServe user ID is
  857.       76244,324.
  858.  
  859.       BBS NETWORK FORUMS
  860.  
  861.       We have established VENDINFO support forums on both the FidoNet and
  862.       RIME networks. We are investigating a VENDINFO forum on GlobalNet.
  863.  
  864.       OTHER ELECTRONIC ADDRESSES
  865.  
  866.       You can reach us through three other computer networks (you can
  867.       usually find a local BBS that's also on these networks).
  868.  
  869.          Our FidoNet address is 1:104/333.
  870.          Our RIME address is 1235 or RAMSISLE.
  871.          Our Internet address is 76244.324@compuserve.com.
  872.  
  873.       FAX
  874.  
  875.       You may reach us by FAX at 303-841-6269.
  876.  
  877.       VOICE TELEPHONE
  878.  
  879.       You may reach us by voice telephone at 303-841-2848.
  880.  
  881.  
  882.  
  883.  
  884.    VendEdit Editor v1.21             -11-                          Mar 1995
  885.  
  886.  
  887.  
  888.  
  889.    VendEdit User's Guide                                       Installation
  890.  
  891.  
  892.       MAIL
  893.  
  894.       You may contact us by mail at
  895.  
  896.          Rams' Island Software
  897.          7644 E. Lakecliff Way
  898.          Parker, Colorado 80134-5904
  899.          USA
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.    VendEdit Editor v1.21             -12-                          Mar 1995
  944.  
  945.  
  946.  
  947.  
  948.    VendEdit User's Guide                                    Overall Process
  949.  
  950.  
  951.        
  952.                      +----------------------------------+
  953.                      | Overview of the VendEdit Process |
  954.                      +----------------------------------+
  955.  
  956.       Here's the short form of the instructions for using VendEdit to
  957.       prepare a VENDINFO-equipped package:
  958.  
  959.            ───────────────────────────────────────────────────┐
  960.           │  Work your way left-to-right, and top-to-bottom,  │
  961.           │       through the VendEdit menu structure.        │
  962.           └───────────────────────────────────────────────────┘
  963.  
  964.       Here's a more detailed description of the procedure:
  965.  
  966.          o  If text materials already exist which you would like to use in
  967.             product descriptions, or in the Read-Me, Installation, War-
  968.             ranty, License, etc., use a normal text editor to prepare *.TXT
  969.             files containing these materials. This will work best if you
  970.             use a separate file for each of these, and a separate file for
  971.             each product description.
  972.  
  973.          o  Use VendEdit to prepare the VENDINFO information for the
  974.             product. The simplest approach is to work left-to-right and
  975.             top-to-bottom through the entire VendEdit menu structure, from
  976.             <P>repare through <V>erify. The additional menu items, e<X>port
  977.             and <T>est, will be discussed separately below.
  978.  
  979.          o  Assign a directory for "packaging" the product. Place the files
  980.             that make up the package in this directory. If the product
  981.             involves multiple packages (e.g., multiple diskettes or ZIPs),
  982.             each package should have its own directory. This step can be
  983.             done sooner, but, in any case, it must be done before an actual
  984.             VENDINFO.DIZ file can be prepared.
  985.  
  986.          o  Now start down the items in the e<X>port menu. First, select
  987.             <S>etup to start preparation of the final package. You will
  988.             tell VendEdit where the package directories are, and whether or
  989.             not you want a standard date/time stamp on files that are
  990.             created by VendEdit. You can also look over the files in the
  991.             package from here.
  992.  
  993.          o  The next several items in the e<X>port menu are optional files
  994.             that you might or might not want to include in the package. You
  995.             may direct VendEdit to produce FILE_ID.DIZ and DESC.SDI files
  996.             (we recommend the former, for sure). Since the VENDINFO.DIZ
  997.             file will contain Read-Me and Vendor.Doc style information, you
  998.             may want to point unfamiliar users and vendors to VENDINFO.DIZ.
  999.             For this purpose, VendEdit will product small "stub" files
  1000.  
  1001.  
  1002.    VendEdit Editor v1.21             -13-                          Mar 1995
  1003.  
  1004.  
  1005.  
  1006.  
  1007.    VendEdit User's Guide                                    Overall Process
  1008.  
  1009.  
  1010.             READ_ME.1ST and VENDOR.DOC or VENDOR.TXT, which simply refer
  1011.             the user to VENDINFO.DIZ. Finally, you may produce a small
  1012.             READ_ME.BAT file, if you wish, which will invoke the DOS "more"
  1013.             command on VENDINFO.DIZ to allow the novice user to easily read
  1014.             the VENDINFO front text.
  1015.  
  1016.          o  At this point (proceeding down the items on the e<X>port menu),
  1017.             you'll be given a chance to check the package. You must get the
  1018.             files in their FINAL CONDITION before producing VENDINFO.DIZ
  1019.             files. That's because the VENDINFO.DIZ file contains a Packing
  1020.             List, which can be checked against the package actually
  1021.             received by your distributor. If any file differs in name,
  1022.             size, date, time, or CRC from those present when you created
  1023.             the VENDINFO file, your package might be rejected.
  1024.  
  1025.          o  Export the VENDINFO.DIZ file.
  1026.  
  1027.          o  Perform the operations on the <T>est menu, to verify that the
  1028.             VENDINFO file you created says what you think it does. THIS IS
  1029.             VERY IMPORTANT!
  1030.  
  1031.          o  If you wish, go back to the e<X>port menu and export a
  1032.             VENDINFO.DOZ file. This file is intended for CD-ROM front ends,
  1033.             electronic media kits, etc. It is NOT included inside your
  1034.             product package (that's what the VENDINFO.DIZ file is for).
  1035.  
  1036.       Your distribution package is now ready.
  1037.  
  1038.       When you release your product, you'll also want to send a copy of the
  1039.       VENDINFO.DIZ file to our Product Registry. That will make it avail-
  1040.       able to many distributors and end-users who may otherwise not know
  1041.       about your product, and it can even generate income for you (see the
  1042.       chapter, "The VENDINFO Product Registry" for details).
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.    VendEdit Editor v1.21             -14-                          Mar 1995
  1062.  
  1063.  
  1064.  
  1065.  
  1066.    VendEdit User's Guide                           Making Intermediate File
  1067.  
  1068.  
  1069.        
  1070.                     +-------------------------------------+
  1071.                     | Making a VENDINFO Intermediate File |
  1072.                     +-------------------------------------+
  1073.  
  1074.  
  1075.  
  1076.    Prepare Text Materials
  1077.    ----------------------
  1078.  
  1079.       VendEdit has the ability to import existing text files into several
  1080.       areas:
  1081.  
  1082.          o  Product descriptions
  1083.          o  Read-Me text
  1084.          o  Installation instructions
  1085.          o  "Other" author material for readable front text
  1086.          o  Product warranty
  1087.          o  License for use and distribution
  1088.  
  1089.       If you're preparing a VENDINFO record for a product that has already
  1090.       been released, you almost certainly have this text written. Even if
  1091.       your product is new, you may find it more convenient to prepare this
  1092.       material with your preferred text editor, and then import it into
  1093.       VendEdit. On the other hand, the text editor inside VendEdit is
  1094.       rather capable, so you certainly don't have to do it this way.
  1095.  
  1096.       If you decide to prepare the text files before using VendEdit, it is
  1097.       suggested that you prepare several different files, using any desired
  1098.       filename and the filename extension TXT. These files can be placed
  1099.       anywhere, but they will be most easily found if they're placed in the
  1100.       VendEdit directory. Possible filenames, with their purposes, are:
  1101.  
  1102.          DESC250.TXT   Product description of not more than 250 bytes
  1103.          DESC450.TXT   Product description of 450 bytes (FILE_ID.DIZ size)
  1104.          DESC750.TXT   Product description of not more than 750 bytes
  1105.          DESC1500.TXT  Product description of not more than 1500 bytes
  1106.          READ_ME.TXT   "Read-Me" text for front of VENDINFO.DIZ
  1107.          INSTALL.TXT   Installation instructions
  1108.          WARRANTY.TXT  Product warranty
  1109.          LICENSE.TXT   License for use and distribution, but note that there
  1110.                        are special requirements for the Distribution License
  1111.                        in a VENDINFO file.
  1112.          OTHER.TXT     Other text sections which the author wants in the
  1113.                        VENDINFO front text.
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.    VendEdit Editor v1.21             -15-                          Mar 1995
  1121.  
  1122.  
  1123.  
  1124.  
  1125.    VendEdit User's Guide                           Making Intermediate File
  1126.  
  1127.  
  1128.       There are some minor format constraints:
  1129.  
  1130.  
  1131.          o  The product descriptions should use a block paragraph structure
  1132.             (no indentation, one blank line between paragraphs). It must
  1133.             use no special formatting (tables, lists that must align like
  1134.             the text you're now reading, boxes around text, etc.). This is
  1135.             because it will be extracted with word-wrapping, and refor-
  1136.             matted using automated tools by the distributor.
  1137.  
  1138.          o  It also must contain no high-ASCII or special low-ASCII charac-
  1139.             ters (all the characters on a normal keyboard are acceptable).
  1140.             This is because it will be printed in catalogs, entered in
  1141.             databases, etc., and such characters are useless or even damag-
  1142.             ing in such situations. If a file containing such characters is
  1143.             read in, all "illegal" characters will be converted to "*", but
  1144.             you may find that less satisfactory than converting such text
  1145.             yourself.
  1146.  
  1147.          o  The "front text" files ("Read-Me", etc.) should be no wider
  1148.             than 73 characters, but they do not have the formatting or
  1149.             character-set limitations of the product descriptions. If you
  1150.             import a text file wider than 73 characters, be sure to refor-
  1151.             mat each paragraph to the proper width (F5 will do a simple
  1152.             paragraph reformat automatically for you).
  1153.  
  1154.       When you have prepared these files, or decided not to, you're ready
  1155.       to <E>dit your first VENDINFO file.
  1156.  
  1157.  
  1158.    Packaging Directory(s)
  1159.    ----------------------
  1160.  
  1161.       There is one other preparation step you should be aware of, though it
  1162.       isn't necessary that it be done before preparing the VENDINFO inter-
  1163.       mediate record. That step is preparation of the directory(s) for your
  1164.       distribution package(s). Before VendEdit can actually produce a
  1165.       VENDINFO.DIZ file, it will need access to a directory containing all
  1166.       the files in your distribution package. Among other things, the
  1167.       VENDINFO file contains a Packing List that has filenames, sizes,
  1168.       dates, and CRCs for all the files in your package, and VendEdit needs
  1169.       access to those files in order to prepare this packing list.
  1170.  
  1171.       VendEdit assumes that the files for a given package are in a single
  1172.       "package directory". These files should be ready for distribution,
  1173.       but not yet "ZIPped up".
  1174.  
  1175.       After you have entered the information that VendEdit requires about
  1176.       your product, you'll reach an eXport Setup menu in which you'll
  1177.  
  1178.  
  1179.    VendEdit Editor v1.21             -16-                          Mar 1995
  1180.  
  1181.  
  1182.  
  1183.  
  1184.    VendEdit User's Guide                           Making Intermediate File
  1185.  
  1186.  
  1187.       specify the package directory path(s).
  1188.  
  1189.  
  1190.    Invoke VendEdit
  1191.    ---------------
  1192.  
  1193.       To invoke VendEdit, simply go to the directory in which you've in-
  1194.       stalled the VENDINFO toolset, and execute the command
  1195.  
  1196.          vendedit
  1197.  
  1198.       Once you've created a VendEdit intermediate file for your product,
  1199.       you can invoke VendEdit on it from the command line, by adding the
  1200.       filename to the command. For example,
  1201.  
  1202.          vendedit INCXT11.PRD
  1203.  
  1204.  
  1205.    Edit Author/Publisher Information
  1206.    ---------------------------------
  1207.  
  1208.       This section of the VENDINFO record identifies the author/publisher
  1209.       and allows very complete contact information to be provided, if
  1210.       desired. Trade association memberships are also noted here.
  1211.  
  1212.       This section should be completed first, and in a single session. The
  1213.       contact information will be copied automatically into the "Orders"
  1214.       and "Support" sections as you exit the Author section. While this may
  1215.       occasionally be unhelpful, it will usually save a good deal of work,
  1216.       since these three sections usually contain much the same information.
  1217.       The trade association information also affects default product
  1218.       descriptions in the "Product" section.
  1219.  
  1220.       The bold exclamation point symbols ("!") on the display call your
  1221.       attention to particularly important help information. There is useful
  1222.       help information associated with virtually every field, but those
  1223.       marked with the "!" symbol should be read even if you skip the
  1224.       others.
  1225.  
  1226.       The "Company Name" and "Queries" (phone) fields have special sig-
  1227.       nificance, and are mandatory (see the help text).
  1228.  
  1229.       Once you have created your first VENDINFO file, you need not enter
  1230.       the Author information again. The F4 (import) key can read a whole
  1231.       "Author" section from an existing file.
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.    VendEdit Editor v1.21             -17-                          Mar 1995
  1239.  
  1240.  
  1241.  
  1242.  
  1243.    VendEdit User's Guide                           Making Intermediate File
  1244.  
  1245.  
  1246.    Edit Product Information
  1247.    ------------------------
  1248.  
  1249.       This section will describe your product in various ways. You will
  1250.       provide information about the product name and version, and filename
  1251.       information for the compressed package(s) in which you distribute it.
  1252.       You will construct (or read from existing text files) product
  1253.       descriptions of various lengths, and select descriptive categories
  1254.       and keywords.
  1255.  
  1256.       The product name, version, and filename information is important to
  1257.       the correct behavior of the VENDINFO tools. Please provide this
  1258.       information carefully, with special attention to the help text as-
  1259.       sociated with the fields marked with an "!".
  1260.  
  1261.       A special section of the Product information is devoted to the Plat-
  1262.       form needs of your product. Here, you can indicate the basic type of
  1263.       computer required, and both minimal and recommended levels of CPU,
  1264.       operating system, memory, clock speed, etc. You can also indicate
  1265.       which of a long list of system features are relevant to your product.
  1266.  
  1267.  
  1268.    Edit Order Information
  1269.    ----------------------
  1270.  
  1271.       This section of the VENDINFO record contains contact information to
  1272.       enable users to purchase the registered version and other products
  1273.       and services. It also indicates the various forms of payment you
  1274.       accept, and other sources of registered versions, if any.
  1275.  
  1276.       The contact portion of this section is very similar in structure to
  1277.       the Author section, though the content you provide may differ. If you
  1278.       edited the Author section first, the Order section will initially
  1279.       contain information from there.
  1280.  
  1281.       Once you have created your first VENDINFO file, you need not enter
  1282.       the Order information again. From within the Order section, the F4
  1283.       (import) key can read a whole "Order" section from an existing
  1284.       VENDINFO file.
  1285.  
  1286.  
  1287.    Edit Distributor Information
  1288.    ----------------------------
  1289.  
  1290.       Within the Orders section, there is an "Other Distributors of Regis-
  1291.       tered Version" area. Many authors will make no use of that area.
  1292.       However, if you have distributors who handle registrations for you --
  1293.       either world-wide or in specified geographical areas -- you will want
  1294.       to list them there. This will help users in their region -- and
  1295.  
  1296.  
  1297.    VendEdit Editor v1.21             -18-                          Mar 1995
  1298.  
  1299.  
  1300.  
  1301.  
  1302.    VendEdit User's Guide                           Making Intermediate File
  1303.  
  1304.  
  1305.       journalists and other distributors, if appropriate -- to get in
  1306.       contact with them. The help text for that section contains more
  1307.       detailed information.
  1308.  
  1309.       One special capability is worth noting. Distributors can use VendEdit
  1310.       to prepare information about themselves in the form of a *.DST file.
  1311.       You can then import the contents of such a file into your VENDINFO
  1312.       file using the F4 key. This allows you to provide your users with
  1313.       good contact information for the distributor, and even information
  1314.       about credit cards and other acceptable forms of payment. See the
  1315.       help text for more information.
  1316.  
  1317.  
  1318.    Edit Support Information
  1319.    ------------------------
  1320.  
  1321.       This section of the VENDINFO record contains contact information to
  1322.       enable your users (and reviewers of your product, etc.) to obtain
  1323.       technical support. This section is very similar in structure to the
  1324.       Author section, though the content you provide may differ. If you
  1325.       edited the Author section first, the Support section will initially
  1326.       contain information from there.
  1327.  
  1328.       Once you have created your first VENDINFO file, you need not enter
  1329.       the Support information again. The F4 (import) key can read a whole
  1330.       "Support" section from an existing file.
  1331.  
  1332.  
  1333.    Edit Price/Benefit Information
  1334.    ------------------------------
  1335.  
  1336.       This section contains information about registration prices and
  1337.       benefits (both a minimum and a maximum registration package can be
  1338.       described, if you have multiple packages). Shipping and handling
  1339.       charges are here, as is information about site licenses, dealer
  1340.       discounts, royalty requirements, and availability of alternative Non-
  1341.       Shareware Versions (NSVs) and Low-Cost Retail (LCR) versions.
  1342.  
  1343.  
  1344.    Edit General (Channel-Independent) Distribution Policy
  1345.    ------------------------------------------------------
  1346.  
  1347.       In this section, you specify your distribution policy, to the extent
  1348.       that it is independent of specific distribution channels. You specify
  1349.       which basic distribution category it falls into:
  1350.  
  1351.          "Commercial" product, not distributable as shareware
  1352.          "Commercial" product, intended for distribution with other products
  1353.          Registered version, not distributable as shareware
  1354.  
  1355.  
  1356.    VendEdit Editor v1.21             -19-                          Mar 1995
  1357.  
  1358.  
  1359.  
  1360.  
  1361.    VendEdit User's Guide                           Making Intermediate File
  1362.  
  1363.  
  1364.          Registered version, intended for distribution with other products
  1365.          Shareware, subject to distribution restrictions
  1366.          Shareware, freely distributable by all channels
  1367.          Freeware, copyrighted but freely distributable and useable
  1368.          Demonstration product, freely distributable by all channels
  1369.          Public domain, freely distributable by all channels
  1370.          Retired product, removal from distribution requested
  1371.          Test version of product, not for further distribution
  1372.  
  1373.       You also specify what changes, if any, you allow to the outer com-
  1374.       pression wrapper and to the files in the package. You can also
  1375.       specify whether or not the distributor is allowed to bundle this
  1376.       product with others, and distribute the bundle.
  1377.  
  1378.       You can provide royalty information, if applicable, and indicate the
  1379.       availability of site licenses, dealer discounts, low-cost retail
  1380.       versions, and non-shareware versions.
  1381.  
  1382.  
  1383.    Edit Channel-Specific Distribution Policy
  1384.    -----------------------------------------
  1385.  
  1386.       In this section, you specify your product's distribution policy for
  1387.       each of 13 distribution channels:
  1388.  
  1389.          Distribution to End User by BBS
  1390.          Distribution to BBSes by File-Distribution Network
  1391.          Distribution to End User by Mail-Order Disk Vendor
  1392.          Distribution to End User by CD-ROM
  1393.          Distribution to End User by Single-Site Rack
  1394.          Distribution to Seller by Rackware Distributor
  1395.          Distribution to End User in Book Enclosure Diskette
  1396.          Distribution to End User by Subscription Service
  1397.          Distribution to End User by Magazine "Cover" Disk
  1398.          Distribution to End User by TV/cable/satellite Broadcast
  1399.          Distribution to End User by 1-900-Type Phone Service
  1400.          Product Installation by Distributor on End User's Machine
  1401.          Distribution by Substantially Different Means
  1402.  
  1403.       Simply select the channels, one at a time, and fill in or adjust the
  1404.       fields that define your distribution policy. Frequent use of the F1
  1405.       (Help) key can assist you with this.
  1406.  
  1407.  
  1408.    Edit Front Text
  1409.    ---------------
  1410.  
  1411.       The five front sections allow you to convey a great deal of informa-
  1412.       tion to the user or distributor even before he installs your product.
  1413.  
  1414.  
  1415.    VendEdit Editor v1.21             -20-                          Mar 1995
  1416.  
  1417.  
  1418.  
  1419.  
  1420.    VendEdit User's Guide                           Making Intermediate File
  1421.  
  1422.  
  1423.       The text of these sections is supplied by you. Before you start your
  1424.       own text for a section, though, it is recommended that you import the
  1425.       "suggested" text and at least read it for ideas. To import this text,
  1426.       just press F3.
  1427.  
  1428.       The License is especially important, and will be somewhat different
  1429.       under the VENDINFO system than your previous licenses have been. It
  1430.       is very important that you consult the help text before completing
  1431.       the text of this section.
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.    VendEdit Editor v1.21             -21-                          Mar 1995
  1475.  
  1476.  
  1477.  
  1478.  
  1479.    VendEdit User's Guide                        Verifying Intermediate File
  1480.  
  1481.  
  1482.        
  1483.                       +---------------------------------+
  1484.                       | Verifying the Intermediate File |
  1485.                       +---------------------------------+
  1486.  
  1487.       The <V>erify menu gives you access to the error-detection capability
  1488.       of VendEdit. Obviously, there are lots of errors the editor can't
  1489.       reasonably be expected to detect, but it can help you avoid certain
  1490.       common mistakes.
  1491.  
  1492.       The <V>erify menu allows you to test for "Errors only", "Warnings and
  1493.       above", or "Comments and above". Before you export a VENDINFO.DIZ
  1494.       file into your package, it is suggested that you use the "Comments"
  1495.       level, and satisfy yourself that the file is OK.
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.    VendEdit Editor v1.21             -22-                          Mar 1995
  1534.  
  1535.  
  1536.  
  1537.  
  1538.    VendEdit User's Guide                                    Exporting Files
  1539.  
  1540.  
  1541.        
  1542.                   +----------------------------------------+
  1543.                   | Exporting VENDINFO.DIZ and Other Files |
  1544.                   +----------------------------------------+
  1545.  
  1546.       Once your VENDINFO information is complete, you can begin to export
  1547.       the various files the VendEdit can produce. It is suggested that you
  1548.       consider the e<X>port menu choices in order, top-to-bottom.
  1549.  
  1550.       The first step, <S>etup, allows you to tell VendEdit the location of
  1551.       your distribution package(s). Be sure to consult the help text if you
  1552.       have any doubt about how this works.
  1553.  
  1554.       Next, you can decide which, if any, of the optional exported files
  1555.       you want. We suggest FILE_ID.DIZ, READ_ME.1ST, and VENDOR.DOC, but
  1556.       you'll have to decide for yourself.
  1557.  
  1558.       Once those are done, you need to verify that your distribution
  1559.       package contains all the files you want it to have, and that they all
  1560.       have the desired date/time stamps if you care about those. The final
  1561.       export step is VENDINFO.DIZ itself, and it will contain a list of all
  1562.       the other files, each with name, size, date, time and CRC value. This
  1563.       will be used at the distributor end to check for changes, par-
  1564.       ticularly those that might violate your distribution license.
  1565.       Naturally, if *you* change a file after VENDINFO.DIZ is constructed,
  1566.       and don't rebuild the VENDINFO.DIZ file, your distributors will be
  1567.       told that the package has been altered. The processor can't tell who
  1568.       made the change.
  1569.  
  1570.       If you wish, you may also export a VENDINFO.DOZ file, for use by CD-
  1571.       ROM front ends, as an electronic media kit, etc. This file does NOT
  1572.       go inside your product package, as does a VENDINFO.DIZ file.
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.    VendEdit Editor v1.21             -23-                          Mar 1995
  1593.  
  1594.  
  1595.  
  1596.  
  1597.    VendEdit User's Guide                                   Checking Results
  1598.  
  1599.  
  1600.        
  1601.                            +----------------------+
  1602.                            | Checking the Results |
  1603.                            +----------------------+
  1604.  
  1605.       The <T>est menu allows you to perform four separate tests on the
  1606.       VENDINFO.DIZ file you've generated:
  1607.  
  1608.            o  Invoke the free VendView end-user viewer (if you have it) and
  1609.               view much of the content of the VENDINFO.DIZ file.
  1610.  
  1611.            o  Visually inspect the readable front text of the VENDINFO.DIZ
  1612.               file, as it will be seen by users and distributors.
  1613.  
  1614.            o  Use the VendPrcs distributor's tool to extract all the infor-
  1615.               mation from the data record into a readable file, and display
  1616.               it.
  1617.  
  1618.            o  Use the VendPrcs distributor's tool to perform a variety of
  1619.               distribution-policy tests, and display the results as they
  1620.               would be seen by a distributor.
  1621.  
  1622.       These tests are VERY IMPORTANT! The VENDINFO file will be the first
  1623.       thing many users and distributors will see about your product. You
  1624.       will also be conveying legally binding distribution rights via the
  1625.       data record. You have a strong interest in making sure it's correct.
  1626.  
  1627.       Once you've done this, your distribution package is complete and
  1628.       ready to be compressed or copied to diskette. Remember to use the
  1629.       correct filename for the compressed package.
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.    VendEdit Editor v1.21             -24-                          Mar 1995
  1652.  
  1653.  
  1654.  
  1655.  
  1656.    VendEdit User's Guide                                   Product Registry
  1657.  
  1658.  
  1659.        
  1660.                        +-------------------------------+
  1661.                        | The VENDINFO Product Registry |
  1662.                        +-------------------------------+
  1663.  
  1664.       The Product Registry is a service that accepts VENDINFO.DIZ files
  1665.       from authors and makes them available to distributors and even end
  1666.       users. There is no charge to the author for this service, and under
  1667.       some circumstances it can even generate a small amount of income for
  1668.       you.
  1669.  
  1670.       Distributors can pay to subscribe to the entire Product Registry
  1671.       collection, either by monthly mailing or by access to the Product
  1672.       Registry BBS. On-line and mail-order queries will be possible by
  1673.       Spring 1994. We can imagine users looking for a particular type of
  1674.       product by category and machine configuration. Or distributors look-
  1675.       ing for business programs they don't have, and which allow distribu-
  1676.       tion by their particular preferred method.
  1677.  
  1678.       In many cases, queries will be paid for on a charge-per-hit basis.
  1679.       One-third of the revenues from such hit charges will be paid to the
  1680.       authors whose products are "hit", so this can not only cause your
  1681.       product to be noticed, but it can even generate a little income for
  1682.       you. No special arrangements are necessary for this payment to occur.
  1683.       It will be paid quarterly; no payments will ever be made until your
  1684.       balance exceeds $15.
  1685.  
  1686.       We're trying hard to make the Product Registry work for everyone. We
  1687.       hope you'll support it by sending us your VENDINFO files.
  1688.  
  1689.       Please send only the MAIN VENDINFO.DIZ file for each product version.
  1690.       If you product has multiple packages, this is the VENDINFO file from
  1691.       the first package. DO NOT send your whole package -- it will be
  1692.       rejected.
  1693.  
  1694.       If you're sending VENDINFO files for more than one product, please
  1695.       rename them using the product filename prefix and the filename exten-
  1696.       sion "DIZ" (e.g., INCXT11.DIZ).
  1697.  
  1698.       VENDINFO files can be uploaded directly to our BBS (the preferred
  1699.       method), mailed on diskette, or sent by CompuServe e-mail or FidoNet
  1700.       crash mail. (Uploads to our BBS are private, visible only to sysops,
  1701.       so it's safe to simply upload the files. "Comments to Sysop" from the
  1702.       Main Menu, are also private, so you can leave a message informing us
  1703.       of your upload without worrying that anyone will see it other than
  1704.       us.) If you're sending the files by e-mail, please compress them
  1705.       using PKZIP or LHA. Please add your Product Registry key (one of the
  1706.       registration codes you were given when you registered VendEdit) to
  1707.       the cover message to assure us that you're the sender. Our electronic
  1708.  
  1709.  
  1710.    VendEdit Editor v1.21             -25-                          Mar 1995
  1711.  
  1712.  
  1713.  
  1714.  
  1715.    VendEdit User's Guide                                   Product Registry
  1716.  
  1717.  
  1718.       and mail addresses are on the front cover of this manual.
  1719.  
  1720.       On an experimental basis, we are also going to try to maintain a
  1721.       collection of screenshots of your products. This will provide a
  1722.       useful service for distributors and journalists who may need shots of
  1723.       your products for catalogs, articles, or perhaps even BBS displays. A
  1724.       screenshot might also help distributors or even end users to decide
  1725.       whether or not to seek out your product. Whether or not we continue
  1726.       this service will depend on its popularity with distributors. We have
  1727.       a fair amount of disk space, however, and should be able to give it a
  1728.       fair test before we decide.
  1729.  
  1730.       If you want to submit screenshots, here's the procedure. You may
  1731.       submit up to three screenshots in each of two graphical formats.
  1732.       Prepare a separate ZIP file (use PKZIP) for each format. Place in it
  1733.       only the screenshots for that format, along with a FILE_ID.DIZ in-
  1734.       dicating what the files are, and identifying your product by name,
  1735.       version, and release date. Rename the ZIP file in the following way.
  1736.       For the filename prefix, use your product filename prefix. For the
  1737.       filename extension, use the filename extension associated with the
  1738.       graphical file format contained in the ZIP, then substitute the
  1739.       letter "Z" for the first character. Thus, INCXT11.ZIF would be a ZIP
  1740.       file containing GIF screenshots for the product "INCXT11". If you're
  1741.       sending screenshots, you must mail them on diskette. They will not be
  1742.       accepted by CompuServe e-mail, as the cost is prohibitive.
  1743.  
  1744.       Distributors are also asked to submit *.DST files for use by their
  1745.       authors. This will make it easy for all your authors to include very
  1746.       detailed information about you with very little effort, so it's in
  1747.       your interest to make these available. You may use an unregistered
  1748.       version of VendEdit to produce these, and they may be sent by any of
  1749.       the methods useable for VENDINFO.DIZ files.
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.    VendEdit Editor v1.21             -26-                          Mar 1995
  1770.  
  1771.  
  1772.  
  1773.  
  1774.    VendEdit User's Guide                                A Bit of Philosophy
  1775.  
  1776.  
  1777.        
  1778.                             +---------------------+
  1779.                             | A Bit of Philosophy |
  1780.                             +---------------------+
  1781.  
  1782.  
  1783.  
  1784.    Philosophy Regarding Distribution Restrictions
  1785.    ----------------------------------------------
  1786.  
  1787.       Both authors and distributors will make more effective use of the
  1788.       VENDINFO system if they understand the point of view from which the
  1789.       system was designed. That point of view is outlined below.
  1790.  
  1791.       Regarding distribution restrictions by author/publishers:
  1792.  
  1793.            o  The author should be able to express any possible distribu-
  1794.               tion restrictions, regardless of whether or not such restric-
  1795.               tions are well-advised.
  1796.  
  1797.            o  Common and/or reasonable restrictions should be encoded in
  1798.               the VENDINFO record in such a way that automated tools can
  1799.               deal with them.
  1800.  
  1801.            o  Other distribution restrictions should be expressible in text
  1802.               form, even if their presence will force conscientious dis-
  1803.               tributors to handle the package manually.
  1804.  
  1805.            o  None of this should be taken as an encouragement for authors
  1806.               to impose distribution restrictions. In many cases, the
  1807.               documentation and help text of the VendEdit editor explicitly
  1808.               discourage restrictions. As an example, the author is advised
  1809.               to consider carefully before imposing ANY restriction on BBS
  1810.               distribution.
  1811.  
  1812.            o  Authors will especially be warned against unnecessary use of
  1813.               options that force manual handling by distributors.
  1814.  
  1815.       Regarding testing for distribution permission:
  1816.  
  1817.            o  In general, a proposed distribution is assumed to be NOT
  1818.               allowed until the distributor clearly addresses each condi-
  1819.               tion required by a product's distribution policy. This isn't
  1820.               done to constrain distribution or to make life difficult for
  1821.               distributors. It is done to protect all parties from acci-
  1822.               dents, misunderstanding, and even legal liability. Thus, if a
  1823.               product can be distributed by a disk vendor only if the per-
  1824.               disk charge is less than $10, VendPrcs will not "OK" the
  1825.               distribution because the vendor fails to mention the amount
  1826.  
  1827.  
  1828.    VendEdit Editor v1.21             -27-                          Mar 1995
  1829.  
  1830.  
  1831.  
  1832.  
  1833.    VendEdit User's Guide                                A Bit of Philosophy
  1834.  
  1835.  
  1836.               charged.
  1837.  
  1838.  
  1839.  
  1840.    Algorithm Used for Distribution Permission Tests
  1841.    ------------------------------------------------
  1842.  
  1843.       Based on the information you provide on the VendPrcs command line,
  1844.       and the distribution policy specified in the VENDINFO file, VendPrcs
  1845.       determines whether or not your proposed distribution satisfies the
  1846.       author's requirements. To do this, VendPrcs looks at the author's
  1847.       policy for the particular distribution channel you've indicated, as
  1848.       well as the channel-independent ("general") distribution restrictions
  1849.       in the VENDINFO file. The actual decision process works as follows.
  1850.       (The important thing to understand is the last step, but you may find
  1851.       it useful to understand the whole decision process.)
  1852.  
  1853.            o  If distribution via the proposed channel is prohibited, then
  1854.               "reject".
  1855.  
  1856.            o  See if distributor is "qualified". The author might indicate
  1857.               that all distributors are qualified. If not, you must meet at
  1858.               least one of the author's qualification criteria to be in
  1859.               this set. Example criteria are: ASP member, non-profit user
  1860.               group, agreeing to "fully inform" your customers.
  1861.  
  1862.            o  If distributor is "qualified", see if any specific behavior
  1863.               removes this "qualified" status, such as charging customers
  1864.               more than allowed.
  1865.  
  1866.            o  Distributor is now either "qualified" or "disqualified". The
  1867.               meaning of this distinction is specified by the author. There
  1868.               are three possibilities:
  1869.  
  1870.                  1. Qualified may distribute without written permission.
  1871.                     Disqualified may distribute only with written
  1872.                     permission.
  1873.  
  1874.                  2. Qualified may distribute without written permission.
  1875.                     Disqualified may not distribute at all. (Obviously,
  1876.                     with the author's written permission, you can do
  1877.                     anything you want; what the author is really telling
  1878.                     you is that written permission won't be given.)
  1879.  
  1880.                  3. Qualified must still have written permission.
  1881.                     Others may not distribute at all.
  1882.  
  1883.            o  Based on your qualified/disqualified status, VendPrcs deter-
  1884.               mines whether or not you need written permission, and whether
  1885.  
  1886.  
  1887.    VendEdit Editor v1.21             -28-                          Mar 1995
  1888.  
  1889.  
  1890.  
  1891.  
  1892.    VendEdit User's Guide                                A Bit of Philosophy
  1893.  
  1894.  
  1895.               or not your proposed distribution is prohibited. If written
  1896.               permission is required, VendPrcs determines whether or not
  1897.               you've obtained it; if not, this requirement is noted in the
  1898.               log and will affect the errorlevel returned by VendPrcs.
  1899.  
  1900.            o  If the distribution is allowed, either with or without writ-
  1901.               ten permission, VendPrcs looks for any additional author-
  1902.               specified conditions you must satisfy, and determines from
  1903.               the command-line flags whether or not you've satisfied them.
  1904.               If any conditions remain unsatisfied (including conditions
  1905.               specified by the author in text form), they are noted in the
  1906.               log and will affect the errorlevel returned by VendPrcs.
  1907.  
  1908.            o  Unless you've disabled VendPrcs testing of executables, all
  1909.               *.EXE, *.COM, *.DLL, *.LIB, etc. files in the package are
  1910.               scanned for VENDINFO records, and a similar decision process
  1911.               is applied to any that are found. This feature is used to
  1912.               detect registered-user versions and commercial and other
  1913.               software not intended for further distribution. (See the
  1914.               later section, "Testing for VENDINFO-Branded Executables".
  1915.  
  1916.            o  VendPrcs now informs you by DOS errorlevel (and in the log-
  1917.               file) that:
  1918.  
  1919.                  1. Distribution is prohibited by the VENDINFO file.
  1920.                  2. Distribution is prohibited by some included executable.
  1921.                  3. Distribution is OK if you satisfy additional
  1922.                     requirements.
  1923.                  4. Distribution is OK if you obtain written permission.
  1924.                  5. Distribution is OK if you obtain written permission AND
  1925.                     satisfy additional requirements.
  1926.                  6. Distribution is approved as-is.
  1927.  
  1928.  
  1929.  
  1930.    Legal Matters
  1931.    -------------
  1932.  
  1933.       The License Agreement for the VENDINFO toolset is a little more
  1934.       complicated than most, and it is important that you familiarize
  1935.       yourself with it. You'll find it in the VENDINFO.DIZ file that came
  1936.       with the toolset, as well as in the VendEdit help system.
  1937.  
  1938.       In addition to the normal functions of a license agreement, this one
  1939.       serves an important role in the VENDINFO system. By requiring dis-
  1940.       tributors to agree to a few simple conditions, it helps protect the
  1941.       rights of authors and the confidence with which authors can use the
  1942.       VENDINFO system. Similarly, authors must agree to a few conditions
  1943.       that help protect the distributor. Details are explained in the
  1944.  
  1945.  
  1946.    VendEdit Editor v1.21             -29-                          Mar 1995
  1947.  
  1948.  
  1949.  
  1950.  
  1951.    VendEdit User's Guide                                           Security
  1952.  
  1953.  
  1954.       license itself.
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.    VendEdit Editor v1.21             -30-                          Mar 1995
  2006.  
  2007.  
  2008.  
  2009.  
  2010.    VendEdit User's Guide                                           Security
  2011.  
  2012.  
  2013.        
  2014.                                  +----------+
  2015.                                  | Security |
  2016.                                  +----------+
  2017.  
  2018.       The security features of VENDINFO make no claim to be hack-proof, but
  2019.       they should be sufficient to:
  2020.  
  2021.            o  Eliminate manual editing of VENDINFO records, which could do
  2022.               serious accidental or deliberate damage.
  2023.  
  2024.            o  Eliminate casual hacking.
  2025.  
  2026.            o  Require effort on the part of a serious hacker that exceeds
  2027.               any likely gain.
  2028.  
  2029.       Some of the security features in the initial release of VENDINFO are:
  2030.  
  2031.            o  The structure, complexity, and internal checks associated
  2032.               with the VENDINFO record are such that it is difficult to
  2033.               produce without a specialized VENDINFO editor.
  2034.  
  2035.            o  The editor cannot edit a distributed VENDINFO file. It
  2036.               produces such files from an intermediate file -- which the
  2037.               author keeps -- in a one-way operation.
  2038.  
  2039.            o  Both the text and data portions of the VENDINFO records are
  2040.               checked for size and CRC.
  2041.  
  2042.            o  VENDINFO records can contain two "authentication" keys that
  2043.               help verify the source and unaltered content of the record.
  2044.  
  2045.            o  The editor will produce "authenticated" VENDINFO records only
  2046.               in the presence of an author-specific key that is not con-
  2047.               tained in the distributed VENDINFO record.
  2048.  
  2049.  
  2050.       Planned capabilities for a subsequent VENDINFO release include:
  2051.  
  2052.            o  If the author chooses, an abbreviated VENDINFO record can be
  2053.               embedded in any or all executable programs. This insures that
  2054.               basic identification and distribution policy information is
  2055.               present and automatically testable even if the VENDINFO
  2056.               record is removed from the distribution package.
  2057.  
  2058.            o  If the author chooses, the executable VENDINFO record can
  2059.               require the presence of a specific VENDINFO file (identified
  2060.               by a CRC-like value). This would allow automatic detection of
  2061.               the removal of the VENDINFO file from the distribution
  2062.  
  2063.  
  2064.    VendEdit Editor v1.21             -31-                          Mar 1995
  2065.  
  2066.  
  2067.  
  2068.  
  2069.    VendEdit User's Guide                                           Security
  2070.  
  2071.  
  2072.               package. It would also allow automatic detection of the
  2073.               substitution of a VENDINFO file in the distribution package
  2074.               even if the file itself passed all security checks.
  2075.  
  2076.            o  If the author places the executable VENDINFO record inside
  2077.               his/her own protective CRC envelope, a complete understanding
  2078.               of the VENDINFO security scheme would not be enough to defeat
  2079.               it. A hacker would also have to defeat the author's own
  2080.               security layer.
  2081.  
  2082.            o  A separate mechanism exists which allows a central site (the
  2083.               Product Registry) to verify the authenticity of a VENDINFO
  2084.               record based on private keys.
  2085.  
  2086.            o  A provision for author tracking brands in the uncompressed
  2087.               front-text of the VENDINFO.DIZ file. These brands will be
  2088.               visible to a file viewer, easily accessible to the author's
  2089.               own software, and defended against modification by in-
  2090.               dividuals other than the author.
  2091.  
  2092.       ll as in the VendEdit help system.
  2093.  
  2094.       In addition to the normal functions of a license agreement, this one
  2095.       serves an important role in the VENDINFO system. By requiring dis-
  2096.       tributors to agree to a few simple conditions, it helps protect the
  2097.       rights of authors and the confidence with which authors can use the
  2098.       VENDINFO system. Similarly, authors must agree to a few conditions
  2099.       that help protect the distributor.
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.    VendEdit Editor v1.21             -32-                          Mar 1995
  2124.  
  2125.